ποΈGitΠ―ΡΠ°ποΈ
docs/srp/user/messages-and-channels.md fix/qr-error-correction (7b45f84f) Text, 12.69 KB
title: Messages & Channels
parent: User Guide
nav_order: 3
last_updated: 2026-07-11
description: Send and receive messages, manage channels, configure encryption, search conversations, and use quick chat, reactions, and message actions.
aliases:
β’ channels
β’ direct-messages
β’ messaging
β’ conversations
Messages & Channels
Meshtastic supports two communication modes: channel broadcasts and direct messages.
ΠΠ°Π½Π°Π»ΠΈ
Channels are shared communication groups. All nodes configured with the same channel key can read and send messages on that channel.
Default Channel
Every Meshtastic device comes with a default LongFast channel. This is an unencrypted channel used for general mesh communication.
Channel Security
Channels support multiple encryption levels:
βββββββββββ¬ββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ΠΠΊΠΎΠ½ΠΈΡΠ° β Security Level β ΠΠΏΠΈΡ β
βββββββββββΌββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β π β PSK (256-bit AES) β Fully encrypted with a strong pre-shared key. Only nodes with tβ¦ β
β π β PSK (128-bit AES) β Encrypted with a shorter key. Secure for most uses but 256-bit β¦ β
β π β Default / Open β Uses the well-known default key. Any Meshtastic device on the sβ¦ β
β β οΈ β Insecure + Position β Open channel that also broadcasts your GPS position. Use with cβ¦ β
βββββββββββ΄ββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β π Security Tip: Always configure a unique PSK for private communications. The default channel is
β intentionally open so new users can discover the mesh β but you should create a separate
β encrypted channel for anything sensitive.
Adding a Channel
1. Navigate to Settings β Channels.
2. Tap Add Channel or scan a QR code.
3. Configure the channel name and encryption key.
4. Share the channel URL/QR code with others who need access.
Tapping a channel shows its details and sharing options.
ΠΠΈΡΠ΅ΠΊΡΠ½Π΅ ΠΏΠΎΡΡΠΊΠ΅
Direct messages (DMs) are point-to-point encrypted communications between two specific nodes.
Sending a Direct Message
1. Open the Messages tab.
2. Select a node from your contacts list or tap a node in the node list.
3. Type your message and tap Send.
Message States
A status label appears under your own outgoing messages only (incoming messages from others show no status label):
βββββββββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β State β Meaning β
βββββββββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β Sendingβ¦ β Queued or already handed to the radio, not yet resolved eβ¦ β
β Delivered to recipient β The strongest confirmation for a direct message β an acknβ¦ β
β Delivered to mesh β For a channel broadcast, the message reached the mesh (brβ¦ β
β Relayed, not confirmed by recipient β For a direct message, shown in a warning color β the messβ¦ β
β Routing via SF++ chainβ¦ β Being routed/buffered by the Store & Forward Plus Plus chβ¦ β
β Confirmed on SF++ chain β Confirmed delivered via the SF++ chain β
β ΠΡΠ΅ΡΠΊΠ° β Delivery failed β tap the status for the specific reason β¦ β
βββββββββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
Delivery Errors
When a message fails to deliver, the error indicator shows what went wrong:
ββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββ
β ΠΡΠ΅ΡΠΊΠ° β Meaning β What to Do β
ββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββββββββββββββββββββββββΌβββββββββββββββββββββ€
β ΠΠ΅ΠΌΠ° ΡΡΡΠ΅ β No path exists to the destination node β The recipient mayβ¦ β
β Got NAK β The next-hop node refused to relay β The relay node maβ¦ β
β ΠΡΠ΅ΠΌΠ΅Π½ΡΠΊΠΎ ΠΎΠ³ΡΠ°Π½ΠΈΡΠ΅ΡΠ΅ β No acknowledgment within retry window β The recipient mayβ¦ β
β No radio interface β No radio interface available to send β Check that your rβ¦ β
β Failed to deliver to mesh β All retry attempts exhausted β Move closer, imprβ¦ β
β Channel/key mismatch β Destination channel/key does not match β Verify both nodesβ¦ β
β Message is too large to send β Message exceeds maximum payload size β Shorten the messaβ¦ β
β No app response β App or plugin did not respond to the request β Retry or check thβ¦ β
β Duty cycle limit β Regional airtime limit reached β Wait for the dutyβ¦ β
β Invalid request β Malformed or invalid request β Retry after updatβ¦ β
ββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββ
β π‘ Tip: Most delivery errors resolve themselves. If a node is intermittently reachable, the mesh
β will retry. For persistent "No Route" errors, check that intermediate Router nodes are online.
Message Features
Quick Chat
Pre-configured messages for rapid communication:
β’ Access via the Quick Chat button in the message input area
β’ Choose from built-in phrases or custom messages
β’ Customize quick chat messages in Settings β Quick Chat
β’ Useful when typing is impractical (gloves, small screen, urgent)
Each quick chat entry has a short Name (the button label), the Message it inserts, and an Instantly send toggle β when enabled, tapping the button sends the message immediately instead of placing it in the input field for editing:
The channel list shows each channel with its latest message preview.
Searching Messages
You can search the full history of any conversation directly from the chat screen:
1. Open a conversation (a channel or a direct message).
2. Tap the search icon in the top bar.
3. Type into the Search messages⦠field. The search runs as you type, across all stored messages in that conversation.
4. Use the N / M result counter and the previous / next arrows to jump between matches, which are highlighted in the conversation.
β π‘ Tip: Search is full-text and stays within the conversation you opened it from β it doesn't
β search across other channels or contacts. It matches against the messages already stored on your
β device, so it works fully offline.
Message Bubbles
Messages appear as chat bubbles β sent messages on the right, received messages on the left. Each bubble shows the sender, timestamp, and delivery status. Messages with replies include a quoted preview of the original message above the response.
Text Formatting
Messages support lightweight inline Markdown. Received messages render the styling with the syntax characters removed:
βββββββββββββββββ¬βββββββββββββ¬βββββββββββββββββββ
β Type β Syntax β Renders as β
βββββββββββββββββΌβββββββββββββΌβββββββββββββββββββ€
β Bold β T383838**bold** β bold β
β Italic β T383838*italic* β italic β
β Strikethrough β T383838~~strike~~ β ~~strike~~ β
β Inline code β BT383838 codeT383838 β monospace T383838code β
β Link β T383838